Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

fwiw you could just put a cdpilot-cli.py in your package.json bin.
but.. i think then you'd recommend npm install -g cdpilot && cdpilot ... instead.

just mentioning cuz i ship diff-so-fancy and git-recent and git-open on npm despite them not being JS.

but.. with the npx command .. probably that at least requires a minimal js wrapper i suppose.

can you sign the cla and make the suggested edit

Hi Paul, thanks for the feedback! You're right that's a simpler shape. I went with a thin Node wrapper for three concrete reasons:

1. Cross-platform Python discovery — On Windows the python3 shebang doesn't fire; the wrapper resolves python vs python3 vs py -3 and surfaces a friendly install hint when none are found. Verified in CI: https://github.com/mehmetnadir/cdpilot/actions/runs/24766371036 (matrix covers ubuntu/macos/windows × py 3.9/3.11/3.12 × node 18/20/22).

2. Browser auto-detection at launch time — Brave/Chrome/Vivaldi/Edge live at platform-specific paths; the wrapper resolves them before delegating so the Python side never has to deal with macOS/Linux/Windows path differences.

3. npx cdpilot as the primary install path — most AI-agent integration cases (Claude Code MCP, etc.) call us via npx cdpilot mcp from a JSON config. A bare Python bin works for npm i -g, but npx would either fall back to system Python with an unclear error or break Windows entirely.

That said, you're not wrong that the wrapper looks heavy. The trade is intentional but I'd love to slim it if there's a better path I'm missing. Either way — would the current shape be acceptable for awesome-chrome-devtools, or is there a specific concern (binary size, install behavior) I should address before we move forward? Happy to iterate.

@googlebot I signed it!